Calendars

The calendar options allow you to create new calendars and modify the settings of the existing one. A calendar is a collection of events and tasks. They are usually stored in a file but it is possible that they come e.g. from a database or even generated on the fly. The different calendar types are provided by plugins which are described below. You can create as many calendars as you like. When you are creating new events and tasks you need to select which calendar will be handling the item. The same item can be stored to multiple calendars too. Common settings Enabled defines if the calendar is active or not. Items from disabled calendars are not shown. Read only hides the calendar from the event and todo dialogs so that you cannot modify or add new items to it. Read only network calendars are also not uploaded to the server even if they for some reason would have changes. Visible category can be used to override the visual appearance of the calendar items. Normally the category in the events and tasks is used when the application determines what the items should look like (i.e. the color of the text and the icons and such). With the visible category you can define a different category that is used instead. It's also useful e.g. for imported items that do not define categories at all. iCalendar The default format for the events and tasks in the iCalendar (RFC 2445). The format is widely used in different calendar applications (not just in Apple's iCal). Rainlendar will keep the events and tasks internally in iCalendar format. Note that if you make modifications directly to the ics-file you must use a text editor that supports utf-8 format (i.e. do not use Notepad). Settings Filename defines the path and name to the file where the will be stored. You can also pick an existing file in which case the events from it are read to Rainlendar and new events will be   Monitor changes checks the calendar file and if it changes it will be reloaded automatically. This works on in Windows. Network Shared Calendar (Pro only) It's also possible to use network shared calendars with Rainlendar. See the Examples page for step by step instructions how to connect Rainlendar to few of the popular network calendars. Settings Url is the location of the shared calendar file. You need to give the full url including the ics-file name (unless the calendar is created dynamically by the web server).  It's possible also to use ftp protocol. WebDAV protocol declaration is also supported (webdav://) but only normal http access is used (i.e. the files are not locked when they are updated). Username defines the user name if the server is password protected. This field can be left empty. Note that the plugin supports only the basic authentication. Password defines the password if the server is password protected. This can be left empty. Poll Frequency can be used to automatically check for updates in the network calendar. The value is in minutes. Value 0 means that the feature is disabled. Do not poll servers too often if they are not yours. Backup can be set to true to make a backup of the ics-file before it is uploaded to the server. This is useful if for some reason the server doesn't accept the file or it gets removed from the server for some reason. The backups are stored in the same folder where the settings are (see Installation). Proxy server defines the name of the proxy server if you need to use one. Proxy username defines the user name for the proxy server. Proxy password defines the user name for the proxy server. Suppress errors can be set to true to make the annoying error dialogs go away. Keep offline copy can be set to true to keep a off-line copy of the network calendar. If the connection with the online version cannot be established the off-line version is used instead. You can use the the off-line calendar normally (i.e. add and modify the events). It will be synchronized with the online version when the connection is up again. Modifications to the existing events and new events are moved automatically to the online version. However this cannot be done with the deleted events so they are copied from the online file back to the off-line when the files are synchronized. So, basically this means that you can permanitely delete events only when the connection is up. Outlook (Windows & Pro only) Rainlendar is able to show Outlook's appointments and tasks among its own events. The items are only read from Outlook and it is not possible to save them back to it. If you try to edit an item that comes from Outlook you cannot save it to the Outlook calendar (but you can do that to some other calendar). Settings Application defines the name of the application that provides the Messaging API. It is possible that also other applications implement the MAPI but even if they do it is not guaranteed that you'll get the events to Rainlendar. Profile defines the Outlook user profile to use. MessageStore defines the Outlook message store that is shown in Rainlendar. Import Alarms can be set to true to import also the alarms. Note that it's not possible to dismiss Outlook alarm from Rainlendar. Use lables instead of categories imports the Outlook lables as Rainlendar's categories.

Skins

There are two modes to select the skin: Simple and Advanced. Simple In the simple mode the list shows all the valid skins. You can just pick the one you like. Note that the skins that were created for the old version of Rainlendar might have functionality that is not supported anymore. Advanced The advanced mode allows you to select which windows in the skin are active. The list in the left side contains all the available skins. The right list has the windows that are currently active. To activate a window expand the skin branch in the available list and click the right arrow to move the window to the active side. You can activate as many windows from the skin as you like but there can be only single instance of the tooltip, trayicon and the alarm window. It is also possible to mix items from different skins. If you for example want to use a tooltip from one skin and the calendar from another it is possible. The system also allows you to activate several instances of the same window. You can for example have two calendar windows active at the same time for multi month display. You should note though that in this case both calendars will show the same month. To fix the problem select one of the calendar windows from the active side and click the Settings-button. The Visible month in the list defines the month that the window displays.  You can set it as +1 to show the next month, -1 to show the previous month, +2 to show the month after the next and so on. If you omit the sign (+ or -) the calendar will show absolute month (1=January, 2=February, ...). The Settings-dialog contains also other values that can be changed for the windows. The Scale can be used to increase and decrease the size of the window. The Visible hides/shows the window. The Grow upwards will make the window to change it's size upwards so that it can be placed to the bottom of the desktop. There might be also other values in the variables section. The variables depend on the skin and are usually described in the skins' details. The filters can be used to define which calendars and/or categories the window displays. If you select a calendar in the Visible calendars only it is shown in the given window. The Included categories and Excluded categories can be used to show and hide certain categories from the window. The filters can be used e.g. to have multiple todo lists where each list would show the contents of a separate ics-file. The tray icon has a different settings where you can define the actions for left and right mouse clicks. You can use the same actions as with the hotkeys. Note that if you define an action for the right mouse button it will override the context menu that you normally get.

Hotkeys (Windows only)

The hotkeys options allows you to run scripts when some key combination is pressed. Few default scripts come with Rainlendar but you can create your own scripts too. Any script that has prefix "Hotkey_" will be shown in the list and can be activated by a hotkey. Note that the hotkeys are global. This means that any time you press the key combination the script will be executed. Rainlendar doesn't need to be active or even visible for this to happen.

Advanced

The advanced options contain all kinds of settings that affect minor details in Rainlendar. Usually you don't have to worry about these unless you want to configure Rainlendar exactly for your liking. Time format Overrides the time format. The different codes can be found from here. If left empty the default format is used (in Windows that's whatever you have set in your locale and in Linux that's %H:%M). Date format Overrides the date format. The different codes can be found from here. If left empty the default format is used (which is whatever you have set in your locale). Weekend days defines the weekend days. This affects the appearance of the calendar (the weekends are usually drawn with a different color) Week number delta defines a value that is added to the week numbers. You can use this to adjust the week numbering if your country is using some non-standard way to number the weeks. Also negative numbers can be used. Default categories lists the categories that are shown in the category list. You can add as many new categories as you like. Note that the unless the category's appearance has been defined in the skin, it is drawn with the default event appearance. Show categories from the skin adds the categories that are defined in the currently used skin to the event and task dialogs. Normally they only list the categories defined in Default categories. Snap distance defined the distance in pixels after which the windows are snapped together and to the edges of the screen. Currently this feature works only in Windows. Snap center can be set to true to snap also the center of the screen. Save window position stores the window positions to the configuration file. If set to false the windows are always opened to the default position. Show tray icon can be used to hide/show the tray icon. Keep on screen puts the windows always inside the screen area when they are opened. Always show full menus defines whether the full context menus are used in all windows or just the item's submenu. You can always show the full menus if you keep shift key down when you open the menu. Disable keyboard shortcuts disables all keyboard shortcuts except the user defined hotkeys. Show in all desktops (Linux only) can be set to true to put Rainlendar to all desktops. If set to false the windows are only on one of them. Calendar wheel scroll defines the number of months the wheel scrolls. Set to 0 to disable the feature. Negative values can be used to scroll to the opposing direction. List wheel scroll defines the scrolling speed in the event and to do lists. Transparency type defines the type of transparency that is used. The native (available only in Windows) is a proper transparency which means that you can see what's happening behind the window (unless the window is opaque). The copy transparency takes a copy of the desktop and draws the window contents over the image. The region transparency creates a region from the alpha channel and sets it for the window. You can only have fully opaque or transparent pixels with region transparency. Copy transparency sleep time defines the time (in ms) how long the window is kept hidden when the copy transparency needs to take a copy of the desktop. If you the background is not copied correctly try increasing this value. Fade delay defines the time (in ms) how long it takes before the window fading is started (e.g. when mouse over fading). Fading works only with native transparency. Fade duration defines the time (in ms) how long it takes to fade the window. Fading works only with native transparency. Font scale can be used to scale the fonts by certain amount. The value is in percents so 100 means normal scale and 200 means double size. Skin language selects the language that is used in the skin. The list shows all the languages that the skin contains. Set to default to use your locale's language. Note that only the languages from the currently active skin is shown. If you change the active skin you need to apply the settings and open the options dialog again to see the new languages in the list. Create backups automatically stores the settings and events to a backup file every time Rainlendar is started. If something goes wrong you can then restore an earlier backup. The 10 previous backups are kept. Show delete confirmations opens a confirmation dialog when you try to delete an event or a task. Combine icons in the calendar prevents the same icons from being displayed twice in the calendar window. So, if you e.g. have two events on the same day with same category, the calendar will only display one icon for them (normally both events would have their own icon). Show tooltips can be used to disable the tooltips altogether. If set to false the tooltips are not shown when you move the mouse over an item on the calendar or on the lists. Max tooltip window width defines the maximum width of the tooltip window. The value is in pixels. Show description in tooltip can be used to hide/show the event description from the tooltips. If set to false only the summary part is shown. Todo items in tooltip defines what information the tooltip should contain for the tasks. Traytip show duration defines the time (in ms) how long the tray tooltip is shown. The tooltip can be closed also by clicking it. Tooltip fade duration is the same as FadeDuration but for the tooltip window. Tooltip show delay specifies the amount of time the mouse must be over an item before the tooltip is shown. Show full task summary can be used to display the full summary in the to do list. If set to false, only the part of the summary that fits in one line will be shown. If set to true, the summary is wrapped to multiple lines. Show task due time can be used to show/hide the due time from the to do list. Show task location can be used to show/hide the location from the to do list. Show full event summary can be used to display the full summary in the event list. If set to false, only the part of the summary that fits in one line will be shown. If set to true, the summary is wrapped to multiple lines. Show event start time can be used to show/hide the start time from the event list. If this is false the end time is not shown either. Show event end time can be used to show/hide the end time from the event list. Show event location can be used to show/hide the location from the event list. Hide dismissed events can be used to show/hide the dismissed events from the event list. A dismissed event means that its alarm has been dismissed. Number of days the list shows defines the number of days that are displayed in the event list. Only the days which contain events are displayed. Header format defines the format that is used in the event list headers. The different codes can be found from here. If this is left empty the event list uses strings like Today, Tomorrow, Monday in 2 weeks, ... Age from start of the week defines how the EventListHeaderFormat shows the weeks. If this is set to true the days that are on the next week (as defined in the general settings) are displayed as Monday next week, Tuesday next week, etc. The days on the week after that are displayed as Monday in 2 weeks, Tuesday in 2 weeks, etc. If this is set to false the event list shows the headers like before except that the postfix is not defined by the start of the week but the number of days from the current date. For example if today is Sunday, the next 6 days are displayed as Monday, Tuesday, etc. The next Sunday and the days after that will be displayed as Sunday next week, Monday next week and so on. Show alarm start time can be used to show/hide the start time from the alarm. If this is false the end time is not shown either. Show alarm end time can be used to show/hide the end time from the alarm. Show alarm location can be used to show/hide the location from the alarm. Keep alarm always on top keeps the alarm window always on top of other windows. Default snooze time defines the number of seconds that the alarm snoozes. The default value is 60 (i.e. one minute). Max alarm window width defines the maximum width of the alarm window. The value is in pixels. Hide from alarm after days defines the number of past days that are checked for non-dismissed alarms. If the event's start time or task's due time is further in past than that the value the alarm window will not show it. The value is in days. Default alarm file defines the default audio file that is played when the alarm is shown. Only WAV files are supported. Manager event columns defines the columns that are visible in the Manager's event list. Each number represents a single columns. You can change the order of the columns or hide some of them completely by removing the number from the list. Do not add that same number twice and do not add numbers that are higher (or lower) than there are available columns. Manager todo columns is the same as ManagerEventColumns but for the task list. Reset All Settings will clear all your current settings and reset them to the default values. Basically what this does is that it just deletes the rainlendar2.ini file which contains the settings. So, after you press this button Rainlendar will behave like it was just installed. Note that it does not affect your events or tasks except that you might need to create the calendars again.